0.1 Obsidian .obsidian 目录

在 Obsidian Vault 下,有一个 .obisidian 目录,它存储了 Obsidian 的所有配置,比如:快捷键、主题、三方插件等。我使用 obsidian-git 在多设备间同步 Obsidian 笔记。其中有一个细节点,便是考虑 .obsidian 中哪些要同步,哪些要 ignore?

目录结构

以我自己的 .obisidian 为例,包含以下内容:

目录/文件 说明 备注
plugins/ 存储所有三方插件 存储了插件源码及设置项
snippets/ 自定义 CSS
themes/ 存储下载的主题 存储了主题 CSS 代码
app.json Obsidian 设置项
appearance.json Obsidian 外观设置项
backlink.json
bookmarks.json 书签存在这个文件中
community-plugins.json 所有安装的三方插件
core-plugins-migration.json
core-plugins.json 启用内置插件
daily-notes.json 日记设置
graph.json 图谱设置项
hotkeys.json 自定义快捷键
page-preview.json
templates.json 模板设置
types.json 存储定制元数据的类型
workspace.json 保存了当前页面布局,包括打开的 Tab、分屏等 不建议放入 git,变化太频繁

Git gitignore

在《0.0 Obsidian 介绍#多设备同步》中提到,我使用 obsidian-git 在多设备间同步 Obsidian 笔记。其中有一个细节点,便是考虑 .obsidian 中哪些要同步,哪些要 ignore?

最初,我 ignore 了整个.obsidian 目录,导致我插件需要在不同设备上手动安装、配置一遍,费时费力。并且未来插件的升级、卸载,都需要每个设备配置一遍。当时还不了解目录结构,不敢动 .obsidian,只好默默忍受。

现在了解了.obsidian 目录结构后,发现问题还是很简单的,只需要以下两点:

  1. .obsidian 目录可以加入 git 版本管理
  2. 但是要把 workspace.json 给 ignore 掉

最终的 .gitignore 很简单,只有一行:

workspace.json

# recent-files-obsidian 记录历史打开文件的
# 多设备下,不同步这个文件,避免冲突
.obsidian/plugins/recent-files-obsidian/data.json

本文作者:Maeiee

本文链接:0.1 Obsidian .obsidian 目录

版权声明:如无特别声明,本文即为原创文章,版权归 Maeiee 所有,未经允许不得转载!


喜欢我文章的朋友请随缘打赏,鼓励我创作更多更好的作品!